Bentley Descartes CONNECT Edition

Resampling dialog box

Used to apply a geometric correction model to an uncorrected image. The input data is transformed into an output data set that belongs to the base coordinate system, directly compatible with the base vector data that was used to create the model. Choose To Image from the Apply menu of the Register dialog box to access the Resampling dialog box.



SettingDescription
Input Image field

The Input Image field displays the name of the input image file. Click the Select button to open the File Selection dialog box. This dialog box is used to select an existing image file for resampling.

When non-georeferenced rasters are selected in the Resampling dialog box menu, .RGR data cannot be applied properly to the raster. As a workaround, users can go to the Register menu, attach the .RGR file and press the Resample Image toggle to apply the .RGR transformation to the attached (non-georeferenced) image, but to be clearer it should be stated in the DC Help that input images in the Resample dialog box should already be georeferenced (raster header or worldfile).

Model field

The Model field displays the name of the transformation model file. If there is an active model in the Register dialog box, it displays in this field. You are prompted to save it if you have made changes since the last save.

To change the current selection, click the Select button to open the File Selection dialog box. This dialog box is used to select an existing RGR transformation model file for the resampling process.

CAUTION: A model is always connected to the input image through the following parameters found in the header: Origin, Dimensions, and Pixel Size. If you change any of them, the model is no longer valid for this image.

Create a new image

Used to choose whether you would like to actually resample the image or simply use the transformation matrix to apply your changes.

The toggle is automatically checked when the Resampling Dialog opens, but when a Helmert, Similitude, or Affine model is selected, the toggle is automatically unchecked but remains enabled. When a Projective, Thin Plate Spline or Polynomial model is selected, the toggle is checked and disabled, since the transformation matrix does not support these models.

Note: Because the transformation matrix is a new addition to Bentley Descartes, Register operations performed solely with the transformation matrix will not appear if the file is opened in Bentley Descartes 6.0. If you plan to use an image in a previous version of Bentley Descartes and would like it transformed, you may wish to resample the image at this time.

Note: Only file formats which support a transformation matrix will maintain mirroring operations stored in the transformation matrix. For all file formats without a transformation matrix, such as standard TIFF or BMP files, Bentley Descartes adds a worldfile. However, if this TIFF or BMP are opened in an application where worldfiles are not supported, the information in the transformation matrix will not be applied to the image. If you plan to use a file format which does not support a transformation matrix in another application, you may wish to select Create A New Image and resample the image at this time.

If you decide to use a file format that does not support a transformation matrix, it is possible to resample the image using its own transformation matrix. In order to do this, simply leave the Model: field empty and resample. You can also resample a file with its own transformation matrix by using Save As or Batch Convert.

Output Image field

The Output Image field displays the name of the output image file. Click the Select button to open the File Selection dialog box. This dialog box lets you specify the name of the image file that will be created by resampling.

All Input Image

Use All Input Image to define the output window in such a manner that it covers the input image entirely.

All Input Image/Input

Click the Input button with the All Input Image option to open the Input Image Window dialog box. The name of the input image displays in the title bar. No parameter of this dialog box can be edited. This dialog box is used only to display the actual window of the input image, as well as with content reflected in the header of this image.

All Input Images/Output

Click the Output button with the All Input Image option to open the Output Window dialog box. The name of the output image displays in the title bar.

If an output image is not selected, Untitled is displayed. No window parameter (origin or dimension) of this dialog box can be edited. The dialog box is used only to display the window of the output image.

The output window is calculated automatically to cover the entire input image. Only the description of the output image and the pixel size can be entered using the Output Window dialog box. This information is used to prepare the header of the output image.

Specified through Input

Use the Specified through Input option to define the output window through another window which is set in the input system of coordinates.

Specified Through Input/Input

Click the Input button to specify the origin and the dimensions of the input window. The name of the input image and other information is displayed, but cannot be edited. When the output window is set through the input space, it adjusts accordingly and in such a manner that it covers the input window entirely.

Specified Through Input/Output

Click the Output button to open the Output Window dialog box. The name of the output image displays in the title bar. If an image is not selected, Untitled is displayed. No window parameter (origin or the dimensions) of this dialog box can be edited. The dialog box is used only to display the window of the target output image. The values are calculated automatically to cover the input window entirely. Only the description of the output image and the pixel size can be entered using the Output Window dialog. This information is used to prepare the header of the output image.

Warping Window

Use the Warping Window option to define the output window by setting its equivalent to the warping window defined with the Warping Window dialog box.

Note: The Input and Output buttons behave like the All Input Image option described above.

Specified in Output Space

Use the Specified in Output Space option to define the output window by setting it directly in the output space.

Note: With the Specified in Output Space option, the Input button is not accessible.

Specified in Output Space/Output

Click Output button with the Specified in Output Space option to open the Output Window dialog box. The name of the output image displays in the title bar. If an image is not selected, Untitled is displayed. This dialog box can be used to specify the true origin and dimensions of the output window. All other fields can also be entered or edited in order to prepare the header of the output image.

Type

Three algorithms can be chosen through the Type option menu:

  • Nearest Neighbor

  • Bilinear Interpolation

  • Cubic Convolution

The Nearest Neighbor algorithm uses only one input pixel. Bilinear Interpolation uses the four nearest neighbors and calculates the weighted mean. Cubic Convolution uses a four by four matrix of pixels and calculates a type of weighted mean.

The Nearest Neighbor algorithm is faster, but it can cause jagged edges or lines on the output image. Cubic Convolution usually produces the best results, but the calculation requires more time to process than the other algorithms. The Bilinear Interpolation provides a compromise in quality of output and time to process.

Note: With a gray scale image, all three options are offered. With a color image, only Nearest Neighbor is available.

Pixel Size

Three choices are available:

  • Keep File Size

  • Same Pixel Size

  • User Defined.

Use the Pixel Size field to enter the size of pixels for the output image. With the “User Defined” option, you can enter different X and Y value .

Note: Except for special effects, it is recommended that you set the pixel size of the output image equal to or close to the pixel size of the input image.

Background Color

The background color is a RGB color number used to initialize the output image file prior to resampling. Therefore, any part of the output image which is not covered by resampled pixels remains this color. You can enter the background color index into the Background Color field. You can also select the color with the color picker that pops up when you click the color button.

Page Up/Page Down

In Register, each file submitted for resampling has each of the resampling parameters displayed in the Job Manager group boxes. The values for each file can be viewed and edited by scrolling the individual pages. Use the Page Up or Page Down buttons to move from the current page to the previous or next page. If the Page Down button is pressed when there is not an additional page, a prompt asks you if you wish to open a new page. If you open a new page, it is created with the default parameters.

Delete Page

Click the Delete Page button to delete the current page and all of its parameters. This page is removed and all following pages are renumbered. If the first and only page is deleted, it remains open and the parameters are established with the default settings.

Delete All

Click the Delete All button to delete all pages but the first page. The parameters of the first page are established with the default settings.

Run Page

Click the Run Page button to start the resampling process according to the parameters of the current page. Before a job is run, the available disk space is checked based on the estimated file size. If the Data Compression is None and there is not enough space, the resampling job is not run and you are notified by a warning box.

While the batch program is running, a Progress window provides feedback. After the job is completed or terminated, a Report line displays the result of the processing corresponding to this page. It indicates whether the processing was successful and, if not, it declares what error or event caused it to be unsuccessful.

Run All

Click the Run All button to start the resampling process of all pages, one at a time, according to the parameters of each page. While the batch program is running, a Progress window provides feedback. For each page, a Report line displays the result of the batch processing job corresponding to this page. It indicates whether the processing of this job was successful and, if not, it declares what error or event caused it to be unsuccessful.

Page

The Page field indicates the number of the current page and the total number of pages prepared.

Report

For each page, a Report line displays the result of the processing that corresponds to this page. It indicates whether the processing was successful and, if not, it declares what error or event caused it to be unsuccessful.

File menu

The File menu of Resampling provides access to all necessary options to manage Resampling files (RSP files). A Resampling file is used to save a schedule of images to be resampled. It can be opened later and be batch processed.